WriteSlaveAlias

将别名位址写入 EtherCAT 从站。

语法

KsCommandStatus WriteSlaveAlias(
     int SlaveId,
     WORD Alias
);

参数

SlaveId：即从站索引 (Slave Index)。此索引是 KINGSTAR 主站于 EtherCAT 网路启动时，根据实体连接顺序自动指派的。直接连线到主站的第一个装置会被指派为索引 0 (Index 0)，接著是索引 1、索引 2，依此类推。即使新增、移除或重新连线装置，这些索引在从站阵列中也会保持一致。请参阅 热插拔 (HotConnect)、修复与重启 中的使用案例以了解更多详细资讯。

Alias：欲使用的的别名位址。请见 SlaveStatus 结构中的 AliasAddress。

回传值

回传 KsCommandStatus 结构。

备注

一些 EtherCAT 从站不开放变更别名位址，若主站对从站写入一个从站无法接受的值，则从站可能会显示错误并拒绝启动。

可用的 EtherCAT 状态

ecatInit, ecatPreOP, ecatSafeOP, ecatOP

范例

const WORD newAlias = 5;
WaitForCommand(3, TRUE, WriteSlaveAlias(0, newAlias));

使用需求

参见

ReadSlaveAlias